Cream of the Crop 12

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / DB2FTP94.ZIP / DBQ2FTP.DOC < prev next >

Wrap

Text File | 1996-04-07 | 21.5 KB | 526 lines

┌───────────┐ └───┐ ┌───┐ │ ┌──────┐ ┌──────┐ ┌───────┐ ┌──────┐┌─────────┐┌────────┐ │ │ │ │ │ ┌──┐ └┐│ ┌──┐ │ │ ┌───┐ │ │ ┌────┘└───┐ ┌───┘│ ┌────┐ │ │ │ │ │ │ │ └┐ ││ │ │ │ └─┘ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └───┘ ││ │ │ │ ┌─────┘ │ │ └──┐ │ │ │ └────┘ │ │ │ │ │ │ ┌───┐ ││ │ │ │ │ ┌─────┘ │ ┌──┘ │ │ │ ┌──────┘ │ │ │ │ │ │ │ ││ │ │ │ │ │ │ │ │ │ │ │ ┌───┘ └───┘ │ │ └───┘ ││ └──┘ │ │ └─────┐ │ │ │ │ │ │ └───────────┘ └───────┘└─────┐└┐ └───────┘ └─┘ └─┘ └─┘ └─┘ ─────────────────────────────────────────────────────────── D'Bridge Queue To FTP Version 0.94ß ─────────────────────────────────────────────────────────── Khile Klock The Computer Hotline! (503) 928-9535 300 - 14,400 Bps FidoNet 1:357/1 FidoNet 1:357/2 FamilyNet 8:7706/0 hotline@proaxis.com klockk@hotlin.fidonet.org ─────────────────────────────────────────────────────────── Documentation Updated 4/07/96 DBQ2FTP v0.94ß Page ii Important Information - Please Note: ─────────────────────────────────── This version of DBQ2FTP is a wide ßeta! What's that mean? Well, I've tested it enough to ensure it works on my system, and I'm currently running three FTPMail links using this software. Before you install this software, it is recommended that you first make a backup of your hard disk, or at least all your configuration files. I don't say this because I expect problems, but I have no idea whether this software will function on your system. If it does, I can't guarantee what it will do. I DO know what it SHOULD do, and let's hope it does. If you are running this software, I expect to hear from you so I know who is running it! I also expect you to send me bug reports so I can fix the bugs and improve the software. If you wish to send in a feature request, please send it to any of the addresses listed at the end of this documentation, along with complete descriptions of what your bug or feature request is, and how it might be implemented. DBQ2FTP v0.94ß Page 1 What is DBQ2FTP? ──────────────── DBQ2FTP (D'Bridge Queue to FTP) is a program designed to take care of the problem of getting D'Bridge in it's native mode to interface with FTPMail setups. Since D'Bridge has a completely unique mail handling setup, i.e. NetMail and Echomail are managed via a series of queue files generated by D'Bridge, and are NOT anything like standard FidoNet Mail handling formated files. All of the current MOVEMAIL type programs available today simply do NOT work when it comes to D'Bridge. (In fact, I was told "Good Luck!" when I first started looking into setting up a FTP- Mail system. DBQ2FTP simply Bridges (Pardon the pun) the gap between D'Bridge and the more traditional FidoNet Style Packets and Arcmail, including NetMail, and FTSC compliant file naming conventions. This in turn allows one to make use of FTP Type programs for manag- ing FTPMail. I use KA9Q for my setup, and will use that for my examples in this documentation. Legal Stuff ─────────── Not that anything should go wrong, but there are no implied war- ranties, or guarantees that come with this program. If you choose to use it, you take all responsibility for whatever happens if some un- natural act should happen. Necessary Stuff ─────────────── You will need to be running "D'Bridge", and there's an assumption that you are looking at this documentation so you can get your D'Bridge system interfaced with a program like KA9Q for FTPMail transfer. New in Version 0.94ß -------------------- This is the third official wide ßeta of DBQ2FTP! Given the proper configuration file, DBQ2FTP will scan your D'Bridge queue for out- bound Netmail Packets, XMail, Areafix Requests, and File Attaches looking for D'Bridge queue entries destined for the configured destination node. More than one FTPFeed can now be configured within a single configuration file! You can now also control which priority of NetMail and XMail are sent via FTPMail! DBQ2FTP v0.94ß Page 2 How Does it Work? ───────────────── Once DBQ2FTP is installed, everything is automatic, but of course, at first you have to set the bugger up yourself. DBQ2FTP takes a look at your D'Bridge generated Disk-Based Que directory and looks for entries for your configured FTPFEED System. Once the entries are found, DBQ2FTP will handle the movement and generation of FTSC Compliant packets, ArcMail and File Attach (XMIT) Entries (This includes misc. items as ".TIC" files and their associated file echo files, Outbound AreaFix requests, and D'Bridge Routed NetMail (Based on your D'Bridge routing setup for the current Event.)). To set up DBQ2FTP, you will need to edit the supplied DBQ2FTP.CFG configuration file using your favorite text editor, like QEdit, or vi for you unix folks <Grin>. Just follow the examples, and you'll have DBQ2FTP configured in re- cord time! Here is what you'll see when you enter the configuration file. Example Configuration File: ─────────────────────────── Look for the file named DBQ2FTP, this is your example. Configuration Definitions: ────────────────────────── ; Anything following a semi-colon is considered a comment and wil be ignored. (Blank lines are also ignored.) SYSOP This should be self explanitory. If not, ask your mom! NODE Enter your fully qualitied 4 dimentional FidoNet Address after this KEY WORD. (If you don't want to use 4D addressing, we'll drop back to 3D with a warning and assume point = 0.) LOGFILE Enter the full path and filename of the file you wish to have runtime info logged into. If you only specify the log filename itself, the log will be created in the directory you run DBQ2FTP from. NETDIR Enter the full drive and path to your *.Msg NetMail directory. PKTDIR Enter the full drive and path to your packet directory. Note: In D'Bridge's setup, it's called the "Temporary Que path". QUEDIR Enter the full drive and path to your QUE (Disk-Based Que) directory. Note: In D'Bridge's setup, it's called the "Outbound Que path". DBQ2FTP v0.94ß Page 3 FTPIN Enter the full drive and path to your inbound FTP directory where your KA9Q (or other application) scripts will receive your FTPMail into. Note: This KEY WORD is currenty looked for, but implementa- tion is not yet complete. DBQ2FTP currently doesn't currently do anything for you in regards to inbound FTPMail. (Stay tuned for future releases!) BEGIN This KEY WORD marks the BEGINing of the FTPFeed block. Between this BEGIN key word, and the END keyword, you will define your FTPFeed information. Multiple BEGIN/END pairs can be defined for multiple FTPFeeds. FTPFEED Enter the fully qualitied 4 dimentional FidoNet Address of your FTPMail feed after this KEY WORD. (If you don't want to use 4D addressing, we'll drop back to 3D with a warning.) FTPOUT Enter the full drive and path to your outbound FTP directory. This is the directory that will be uploaded to your FTP feed by your KA9Q (or other application) scripts. When DBQ2FTP is run, anything found / generated for this FTPFeed will be placed in this outbound directory. SEND_CRASH Send Messages marked CRASH. By default, messages marked with a CRASH priority are not processed by DBQ2FTP, leaving them in place for your mailer to deliver via regular telephone calls to your FTPFeed. Using this option will tell DBQ2FTP to process CRASH messages as well. SEND_IMM Send Messages marked IMMediate. By default, messages marked with an IMMediate priority are not processed by DBQ2FTP, but left alone to be delivered by your mailer, via regular telephone calls to your FTPFeed. Using this option will have DBQ2FTP process these messages also. END This marks the END of the BEGIN/END FTPFeed block. Between this END key word, and a previosuly defined BEGIN keyword, you will define your FTPFeed information. Multiple BEGIN/END pairs can be defined for multiple FTPFeeds. Now you will need to edit the batch file that you use to export your FTP outbound Net/Echomail and associated files. (i.e. Areafix Requests, Files attaches, etc) DBQ2FTP v0.94ß Page 4 Editing your batch file ─────────────────────── You will need to have DBQ2FTP running from the batch file that you import your echomail from. Here are some examples of some batch files that deal with incoming mail and call DBQ2FTP in a standard environment. In standard mode, DBQ2FTP recognizes "DBQ2FTP.CFG" as the default configuration file and expects that file to reside in the same drive and directory you executed DBQ2FTP from. If you place DBQ2FTP in some out-of-the way place that is in your path (like "C:\Utility"), when you execute DBQ2FTP, the program is going to expect the default configuration file, "DBQ2FTP.CFG", to reside in the same place. DBQ2FTP has optional command line parameters, and that allow you over-ride the default configuration file as well as the location of your configuration file(s). -C This command line parameter allows you to over-ride the default configuration file name. Example: -CSSTRBONE.CFG -D This command line paramater instructs DBQ2FTP to display "DEBUG" information as it's processing your D'Bridge Queue directories. -H Displays these command-line options so you don't always have to read these DOCS. -P This command line parameter allows you to over-ride the default location of the configuration file(s). Example: I:\NOS -T This command line paramater instructs DBQ2FTP to run in "TEST" mode. This means that DBQ2FTP will not mark SENT or KILL any netmail it processed, nor will it DELETE or TRUNCATE any files that were attached to the NetMail messages. Note however that the files WILL be copied and the FTSC Type-2 packet WILL be created. Warning: If you run in this mode, you CAN create DUPLICATES, which could get you in trouble with your feed. -V This option will LOG the debug information to your log file. DBQ2FTP v0.94ß Page 5 If you use the standard mode of operation configuration filename (DBQ2FTP.CFG), you may omit the "-C" parameter, although you may still wish to indicate it's location with the "-P" parameter. ────────────────────────────────────── cd \nos Rem Move Zstar outbound archives from D'Bridge outbound Rem to ftp transfer directory DBQ2FTP -cSSTRBONE.CFG «─ Call DBQ2FTP w/Config parameter Rem If you wish to copy your outbound files before sending, Rem you need to insert something here! Rem Start Internet connection Rem Use direct screen writes, verbose mode off net15b -d\nos rgn17.net Rem Inbound pre-processing and copying... call rgn-in.btm ────────────────────────────────────── What will it look like? ─────────────────────── DBQ2FTP will append to the configured LOG file file as follows: ───────────────────────────────────── DBQ2FTP v0.94ß system log file ───────────────────────────────────── ******************************************************* Begin Operating as node..............: 1:357/1.0 System Operator................: Khile Klock Network mail path..............: I:\DB\MAIL-OUT D'Bridge Packet path...........: I:\DB\PACKETS D'Bridge outbound queue path...: I:\DB\ARCMAIL FTP inbound path...............: I:\DB\FILES-IN\FTP-IN FTP Feed address # 1 ..........: 1:138/146.0 FTP outbound path..............: I:\DB\FTP-OUT\RGN17 D'Bridge outbound queue name...: 00103U.042 Messages marked CRASH will be sent. Messages marked IMMediate will be sent. FTP Feed address # 2 ..........: 1:396/1.0 FTP outbound path..............: I:\DB\FTP-OUT\SSTRBONE D'Bridge outbound queue name...: 0010B0.001 Messages marked CRASH will be sent. Network mail directory contains: 13 messages numbered 1 to 16. No outbound packets found for. No outbound X-Mail found. End DBQ2FTP v0.94ß Page 6 Ofcourse, the date and time will appear down the left column of the log file so you can see when stuff is happening. Now What? ───────── Nothing else needs to be done! Once you get echomail coming in and going out via FTPMail link(s), DBQ2FTP will do the rest as far as getting your mail from D'Bridge to the FTP Directory! Note: ───── DBQ2FTP may be run from any directory you wish, but it is always advised that you run it from your main NOS or D'Bridge directory. Also, the first time you run DBQ2FTP, you will see a warning entry in the log file as follows: 01/13/96 22:51:18 Warning: Unable to open I:\NOS\00dbff6f.INF! 01/13/96 22:51:18 Warning: Unable to retrieve ArcMail History Information! 01/13/96 22:51:18 No outbound X-Mail found. 01/13/96 22:51:18 End 01/13/96 22:53:18 ******************************************************* This is to be expected since DBQ2FTP hasn't created it's special info file to keep track of ArcMail bundles. This will go away after the first run for EACH FTPMail system you connect to. If this warning persists, you'ld better investigate what's going on. DBQ2FTP creates a special ".INF" info file for each system you connect to. This file is written in the same directory as your configuration file for that system. The file name is the difference between the FEED address and YOUR address in HEX, just the same as the FTSC ArcMail file naming convention, with a ".INF" extention. DBQ2FTP v0.94ß Page 7 Error Level Exits: ────────────────── DBQ2FTP will normally exit with an error level = 0, unless something goes wrong, or there is need to warn the user about something. The following is a breakdown of the various errorlevel exits, and what they mean: 0 = Everything went ok, something was moved 1 = Warnings exist, Something was moved. 2 = Everything went ok, nothing was moved. 251 = Found outbound Que File, Can't Open it! Regenerate your DB Queue! (ALT-Q) 252 = Can't seem to open actual outbound Packet! Regenenerate your DB Queue! (ALT-Q) 253 = Found Packet "Que" File, Can't Open it! Regenerate your DB Queue! (ALT-Q) 254 = Configuration file incomplete! 255 = Configuration file missing! DBQ2FTP v0.94ß Page 8 Registration Cost: ────────────────── Evaluation Period: ────────────────── DBQ2FTP is being released as "Share Ware". I'll share my work with you, and you can try it out. If you find that this suits your needs, then you are requested to send the author a check to help support the future of this software. Future versions will be released as time permits and the need arrises. If you already sent in your registra- tion check, then you're already registered for the next release! It's assumed that 30 - 60 days is more than enough time to "evaluate" this product, after wich you either make a decision to send in a registration check, or perform the graceful act "DEL DBQ*.*". (Although I won't hold my breath!) Standard Site: ────────────── Standard registration of DBQ2FTP is $5.00 US Funds (See DBQ2FTP.REG file). Laser printed documentation, and official software diskette, can be obtained for an additional $5.00, simply to cover the cost of manual production, diskettes, shipping and handling Commercial Site: ──────────────── Commercial registrations of DBQ2FTP run $20.00 which includes laser printed documentation, software on disk in either 5.25" or 3.5" format, and a certificate of registration. All funds should be sent to: Around the Klock Software Att: Khile Klock 626 SW 3rd Ave. Albany, Oregon 97321-0509 Make checks payable to: Khile T. Klock Be sure to fill out the registration form "DBQ2FTP.REG" enclosed in this package. It will help to insure that your registration will be processed correctly and as quickly as possible. DBQ2FTP v0.94ß Page 9 If you have any suggestions, comments, or questions please direct them to: Khile Klock The Computer Hotline! (503) 928-9535 (503) 928-7330 300 - 14,400 Bps FidoNet 1:357/1 FidoNet 1:357/2 Network 8:7706/0 hotline@proaxis.com klockk@hotlin.fidonet.org Support: -------- I am hosting a mailing list here at hotlin.fidonet.org. For more information, send E-Mail to listserv@hotlin.fidonet.org or to auto subscribe, send E-Mail to dbq2ftp-s@hotlin.fidonet.org. Messages should be posted to dbq2ftp@atksoft.hotlin.fidonet.org. I also have the DBQ2FTP echo area, if you wish to feed that way. (Future) Look for new versions of DBQ2FTP on the web at the following URL: http://www.proaxis.com/~hotline. You may also find copies via ftp at ftp.island.net, ftp.sstar.com, or ptmudge.westsound.com. Acknowledgments: ──────────────── 1) Marc Blakely - For reworking KA9Q to allow FTPMail! And putting up with my numerous test messages! 2) John Mudge - Rumagin' through my documentation. (I aso hear he's pushin' for a version for FrontDoor!) 3) John Souvestre - Puttin' up with my test messages! 4) D'Bridge Users - For testing this stuff out for me! 5) My Wife! - Just plain putting up with me!